package org.dromara.knowledge.service;

import com.baomidou.mybatisplus.extension.service.IService;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.knowledge.domain.KnowledgeHitLog;
import org.dromara.knowledge.domain.bo.KnowledgeHitLogBo;
import org.dromara.knowledge.domain.vo.KnowledgeHitLogVo;

import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * 知识库命中日志Service接口
 *
 * @author ruoyi
 */
public interface KnowledgeHitLogService extends IService<KnowledgeHitLog> {

    /**
     * 查询知识库命中日志
     */
    KnowledgeHitLogVo queryById(Long id);

    /**
     * 查询知识库命中日志列表
     */
    TableDataInfo<KnowledgeHitLogVo> queryPageList(KnowledgeHitLogBo bo, PageQuery pageQuery);

    /**
     * 查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryList(KnowledgeHitLogBo bo);

    /**
     * 新增知识库命中日志
     */
    Boolean insertByBo(KnowledgeHitLogBo bo);

    /**
     * 修改知识库命中日志
     */
    Boolean updateByBo(KnowledgeHitLogBo bo);

    /**
     * 校验并批量删除知识库命中日志信息
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 根据会话ID查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryBySessionId(String sessionId);

    /**
     * 根据知识库ID查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryByKnowledgeId(String knowledgeId);

    /**
     * 根据文档ID查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryByDocId(String docId);

    /**
     * 根据知识片段ID查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryByFragmentId(String fragmentId);

    /**
     * 根据模型名称查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryByModelName(String modelName);

    /**
     * 根据相似度分数范围查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryBySimilarityRange(Double minScore, Double maxScore);

    /**
     * 根据查询文本查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryByQueryText(String queryText);

    /**
     * 统计知识库命中次数
     */
    Long countHitsByKnowledgeId(String knowledgeId);

    /**
     * 统计文档命中次数
     */
    Long countHitsByDocId(String docId);

    /**
     * 统计知识片段命中次数
     */
    Long countHitsByFragmentId(String fragmentId);

    /**
     * 获取热门查询列表
     */
    List<Map<String, Object>> getPopularQueries(String knowledgeId, Integer limit);

    /**
     * 获取平均响应时间
     */
    Double getAverageResponseTime(String knowledgeId);

    /**
     * 根据排名查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryByRanking(Integer ranking);

    /**
     * 根据响应时间范围查询知识库命中日志列表
     */
    List<KnowledgeHitLogVo> queryByResponseTimeRange(Long minTime, Long maxTime);

    /**
     * 批量插入知识库命中日志
     */
    Boolean batchInsert(List<KnowledgeHitLogBo> boList);

}